home *** CD-ROM | disk | FTP | other *** search
aaaaffffIIIInnnniiiittttMMMMiiiissssccccIIIIDDDDssss((((3333ddddmmmm)))) aaaaffffIIIInnnniiiittttMMMMiiiissssccccIIIIDDDDssss((((3333ddddmmmm)))) NNNNAAAAMMMMEEEE afInitMiscIDs, afInitMiscType, afInitMiscSize - initialize the list of miscellaneous data chunk ID's in an AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp file configuration structure, initialize the chunk type and number of data bytes for a given miscellaneous chunk. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>> vvvvooooiiiidddd aaaaffffIIIInnnniiiittttMMMMiiiissssccccIIIIDDDDssss((((AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp sssseeeettttuuuupppp,,,, iiiinnnntttt mmmmiiiisssscccciiiiddddssss[[[[]]]],,,, iiiinnnntttt nnnnmmmmiiiisssscccc)))) vvvvooooiiiidddd aaaaffffIIIInnnniiiittttMMMMiiiissssccccTTTTyyyyppppeeee((((AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp sssseeeettttuuuupppp,,,, iiiinnnntttt cccchhhhuuuunnnnkkkkiiiidddd,,,, iiiinnnntttt ttttyyyyppppeeee)))) vvvvooooiiiidddd aaaaffffIIIInnnniiiittttMMMMiiiissssccccSSSSiiiizzzzeeee((((AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp sssseeeettttuuuupppp,,,, iiiinnnntttt cccchhhhuuuunnnnkkkkiiiidddd,,,, iiiinnnntttt ssssiiiizzzzeeee)))) PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR _s_e_t_u_p is an AAAAFFFFffffiiiilllleeeesssseeeettttuuuupppp structure, previously created by a call to aaaaffffNNNNeeeewwwwFFFFiiiilllleeeeSSSSeeeettttuuuupppp(((()))). _m_i_s_c_i_d_s is an array of (unique) positive integer ID's which are used to reference miscellaneous data chunks in a new audio file after it is created by passing _s_e_t_u_p to aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm). _n_m_i_s_c The total number of miscellaneous chunks in the file configuration. See the audio file format man pages aaaaiiiiffffcccc(4), nnnneeeexxxxtttt(4), wwwwaaaavvvveeee(4), bbbbiiiiccccssssffff(4), and ssssoooouuuunnnnddddddddeeeessssiiiiggggnnnneeeerrrr2222(4) for format- specific information. _c_h_u_n_k_i_d is one of the chunk ID's from the _m_i_s_c_i_d_s list. _t_y_p_e is an integer constant which denotes a valid chunk type for the file format being configured with _s_e_t_u_p. _s_i_z_e is a nonnegative integer value indicating the number of bytes to be allocated in the file header for data in the chunk given by _c_h_u_n_k_i_d. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN aaaaffffIIIInnnniiiittttMMMMiiiissssccccIIIIDDDDssss(((()))) initializes a list of unique miscellaneous chunk ID's which are used to reference various file format dependent data chunks in an audio file created by passing _s_e_t_u_p to aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm). After you specify the list of ID's, you have to specify a chunk type and a chunk data area size for each of the ID's by calling aaaaffffIIIInnnniiiittttMMMMiiiissssccccTTTTyyyyppppeeee(((()))) and aaaaffffIIIInnnniiiittttMMMMiiiissssccccSSSSiiiizzzzeeee(((()))). The current valid miscellaneous data types are: PPPPaaaaggggeeee 1111 aaaaffffIIIInnnniiiittttMMMMiiiissssccccIIIIDDDDssss((((3333ddddmmmm)))) aaaaffffIIIInnnniiiittttMMMMiiiissssccccIIIIDDDDssss((((3333ddddmmmm)))) AAAAFFFF____MMMMIIIISSSSCCCC____CCCCOOOOPPPPYYYY Copyright string AAAAFFFF____MMMMIIIISSSSCCCC____AAAAUUUUTTTTHHHH Author/artist string AAAAFFFF____MMMMIIIISSSSCCCC____NNNNAAAAMMMMEEEE Name string AAAAFFFF____MMMMIIIISSSSCCCC____AAAANNNNNNNNOOOO AIFF/AIFF-C annotation string AAAAFFFF____MMMMIIIISSSSCCCC____MMMMIIIIDDDDIIII AIFF/AIFF-C MIDI system exclusive data AAAAFFFF____MMMMIIIISSSSCCCC____AAAAPPPPPPPPLLLL AIFF/AIFF-C application-specific data AAAAFFFF____MMMMIIIISSSSCCCC____PPPPCCCCMMMMMMMMAAAAPPPP PCM mapping information (for future use) AAAAFFFF____MMMMIIIISSSSCCCC____NNNNeeeeXXXXTTTT NeXT file info chunk AAAAFFFF____MMMMIIIISSSSCCCC____IIIIRRRRCCCCAAAAMMMM____PPPPEEEEAAAAKKKKAAAAMMMMPPPP BICSF peak amplitude sfcode AAAAFFFF____MMMMIIIISSSSCCCC____CCCCOOOOMMMMMMMMEEEENNNNTTTT Text comment string. The tags AAAAFFFF____MMMMIIIISSSSCCCC____IIIIRRRRCCCCAAAAMMMM____CCCCOOOOMMMMMMMMEEEENNNNTTTT and AAAAFFFF____MMMMIIIISSSSCCCC____IIIICCCCMMMMTTTT are also allowed for this type, though this chunk is supported by several file types. AAAAFFFF____MMMMIIIISSSSCCCC____IIIICCCCRRRRDDDD Creation date string. This is usually of the form "YYYY-MM-DD". AAAAFFFF____MMMMIIIISSSSCCCC____IIIISSSSFFFFTTTT Software name string. Usually set to the name of the software package which created the sound. AAAAFFFF____MMMMIIIISSSSCCCC____UUUUNNNNRRRREEEECCCCOOOOGGGGNNNNIIIIZZZZEEEEDDDD unrecognized data chunk For AIFF-C (and AIFF) files, you do not need to worry about the "trailing zero pad byte" required at the end of chunks with odd numbers of data bytes. The library hides this implementation detail from applications. When an application creates an audio file by passing _s_e_t_u_p to aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm), the header for the file is written out with zero-filled areas reserved for each of the various requested miscellaneous data types. You use the routine aaaaffffWWWWrrrriiiitttteeeeMMMMiiiisssscccc(3dm) to write data into the chunks after the file has be opened. The application is responsible for managing the contents of the header space reserved for each chunk of miscellaneous data. For example, if the application reserves 1000 bytes of space for MIDI exclusive data, then the application needs make sure that any bytes which aren't used for meaningful data are filled with MIDI no-op messages instead. PPPPaaaaggggeeee 2222 aaaaffffIIIInnnniiiittttMMMMiiiissssccccIIIIDDDDssss((((3333ddddmmmm)))) aaaaffffIIIInnnniiiittttMMMMiiiissssccccIIIIDDDDssss((((3333ddddmmmm)))) CCCCAAAAVVVVEEEEAAAATTTTSSSS The Audio File Library will continue to expand the number of supported file formats and misc types. The ability of these file formats to store various kinds and numbers of miscellaneous chunks will vary. See aaaaffffGGGGeeeettttMMMMiiiissssccccIIIIDDDDssss(3dm) for some important notes about handling this situation. SSSSEEEEEEEE AAAALLLLSSSSOOOO afNewFileSetup(3dm), afOpenFile(3dm), afWriteMisc(3dm) PPPPaaaaggggeeee 3333 
